home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / dfue / fax / qfxlg081 / qfax_log.doc < prev    next >
Text File  |  1992-12-13  |  11KB  |  227 lines
  1. QFAX_LOG 0.81
  2.  
  3. Einführung
  4. ----------
  5. Das Programm QFAX_LOG analysiert die Protokolldatei von QFAX: QFAX.LOG.
  6. Es listet nur die ausgehenden Gespräche auf, um eine Kostenanalyse
  7. zu machen. Es ist ein reines TOS/TTP-Programm ohne GEM-Bestandteile,
  8. da nur eine Eingabedatei zu zwei Ausgabedateien verarbeitet wird.
  9.  
  10. Start
  11. -----
  12. Das Programm kann aus jedem beliebigen Ordner gestartet werden.
  13. Wenn die Datei C:\QFAX.INF nicht existiert, muß QFAX.LOG im Startordner
  14. stehen oder der Pfad per Shell oder als TTP-Anwendung mitgegeben werden.
  15. Existiert die Datei C:\QFAX.INF, so wird dort anhand des Schlüsselwortes
  16. LOGFILE die Log-Datei gesucht.
  17.  
  18. ZON-Datei
  19. ---------
  20. Zusätzlich benötigt das Programm unbedingt die Datei QFAX_LOG.ZON
  21. in dem Startordner. In dieser Datei stehen die Kosten für den
  22. jeweiligen Anrufer bei verschiedenen Zonen. Das Format ersehen
  23. Sie aus der Datei selber. Damit kann QFAX_LOG die Kosten für
  24. die Gespräche ermitteln. Die Auslandsvorwahl muß auch bei deutschen
  25. Nummern (+49) vor der Nummer stehen, getrennt davon mit einem '-'.
  26. Auslandsuser nehmen die entsprechende Vorwahl!
  27.  
  28. ERR-Datei
  29. ---------
  30. Das Programm benötigt nun auch die Datei QFAX_LOG.ERR, in der
  31. die Klartextfehlermeldungen vorhanden sind.
  32.  
  33. Verzögerungszeit
  34. ----------------
  35. Beim Einloggen wurde eine Verzögerungszeit bis zur Erkennung
  36. des Carriers von 10 Sekunden angenommen, was ein guter Mittelwert
  37. sein sollte. Durch diese Verzögerung und die Postbestimmung, das
  38. die erste Gebühreneinheit bis zu 1/12 kürzer sein kann, ist eine
  39. exakte Bestimmung sowieso nicht möglich, aber in der Mehrzal der
  40. Fälle dürften die Gebühren exakt stimmen.
  41.  
  42. Einheit
  43. -------
  44. In der Datei QFAX_LOG.ZON können auch die Kosten je Einheit
  45. geändert werden, falls das einmal von der Telekom geändert wird
  46. (bzw. man von Nebensprechanlagen aus telefoniert).
  47.  
  48. Fehlverbindungen
  49. ----------------
  50. Eine Fehlverbindung in der Protokolldatei QFAX.LOG wird durch ein
  51. 'connect to' ohne 'send x page(s)' angezeigt (in Wirklichkeit ist
  52. dies häufig auch ohne 'connect to' passiert). Bei einer
  53. Fehlverbindung wird die Verzögerungszeit als Verbindungszeit
  54. benutzt, obwohl das auch häufig länger sein kann. Nur wird
  55. das leider nicht korrekt protokolliert. Ebenfalls werden 'error'
  56. und 'senderr', sowie Klartextmeldungen wie 'line busy' usw.
  57. berücksichtigt.
  58.  
  59. Jahrproblem
  60. -----------
  61. Die Datei QFAX.LOG sollte max. ein Jahr enthalten, da das Jahr
  62. nicht mitprotokolliert wird und das vorgegebene Jahr (unter
  63. Berücksichtigung des Jahreswechsels) zur Ermittlung der Sonn-
  64. und Feiertage benutzt wird. Für die Unterscheidung zwischen Tag-
  65. udn Nachttarif wird die Telekom-Regelung benutzt (auch bei
  66. Auslandstelefonaten, die teilweise abweichende Regelungen
  67. haben). Ortsgespräche werden an der fehlenden 0 in der Vorwahl
  68. erkannt und die Vorwahl muß in der Datei QFAX_LOG.ZON an erster Stelle
  69. stehen!
  70.  
  71. Ausgabe
  72. -------
  73. Das Programm erzeugt im Startordner eine Datei QFAX_LOG.EIN,
  74. in der alle einzelnen Telefonate aufgelistet werden (zeitlich
  75. geordnet, so wie sie in QFAX_LOG aufgeführt sind) und eine
  76. Datei QFAX_LOG.ALL, in der alle Gespräche je Teilnehmer aufsummiert
  77. worden sind. Die Dokumentation dazu finden Sie in den Dateien
  78. QFAX_DOC.EIN und QFAX_DOC.ALL. Beide Dateien werden beim Neustart
  79. überschrieben! Die Spaltenbreite der Zahlenwerte richtet sich dabei
  80. nach den real größten auftauchenden Summen. Gekürzt wird bei zu
  81. wenig Platz der Name bis auf fünf Buchstaben Länge. Eine Zeile ist
  82. max. so lang wie eine Bildschirmbreite minu einer Spalte.
  83.  
  84. Deckblatt
  85. ---------
  86. Die Datei QFAX.LOG wird relativ fehlertolerant
  87. analysiert, aber eine Editierung wäre nicht gut. Es sollten in
  88. QFAX.LOG keine Deckblätter abgespeichert sein (nicht ausprobiert).
  89.  
  90. Programmablauf
  91. --------------
  92. Während des Programmlaufes werden die analysierten Gespräche als
  93. Tabelle angezeigt. Am Schluß wird die Tabelle nach Teilnehmernamen
  94. (erster Buchstabe) alphabetisch sortiert. Zu einer Telefonnummer
  95. wird jeweils der zuletzt benutzte Teilnehmername zugewiesen. Die
  96. Telefonnummern sind intern das Sortiermerkmal (bei wechselnden Namen
  97. gebe es sonst Probleme).
  98.  
  99. Export
  100. ------
  101. In den Dateien QFAX_ALL.ASC und QFAX_ALL.DIF werden die Daten aus
  102. QFAX_LOG.ALL auf Wunsch eines Users als Importfile für Datenbanken
  103. weggeschrieben. Bei vielen protokollierten Faxnummern muß man
  104. aber per Hand die nötigen FAXe auswählen oder mit Hilfe der Datei
  105. QFAX_LOG.SEL die interessanten Faxnummern auswählen. Die Datei
  106. QFAX_ERR.TOR enthält ein Exportfile für ein eigenes Tortenprogramm,
  107. das auch beigefügt ist.
  108.  
  109. Auflösung
  110. ---------
  111. Das Programm sollte in jeder Auflösung laufen, außer bei weniger als
  112. 80 Spalten Breite Text, wo es zu einem unschönem Umbruch kommt.
  113. Getestet wurde es auf einem Atari 1040 ST mit TOS 1.04
  114. und NVDI, GEMINI und einem SM124, sowie 1.0 und 2.5 MB RAM.
  115.  
  116. Kritik
  117. ------
  118. Über Kritik - falls das Programm nicht läuft - würde ich mich freuen,
  119. ebenso über Verbesserungsvorschläge. Bei Problemen mit der eigenen
  120. QFAX.LOG bitte ich um Zusendung dieser Datei, damit ich das Problem
  121. anaylsieren kann (bei e-mail bitte vorher packen, als Diskette bitte
  122. auf 720 KB, 3.5 Zoll). Aber auch eine einfache e-mail wie
  123. 'nettes Programm' freut mich. Jeder Hinweis auf einen wirklichen
  124. Bug wird mit einem kostenlosem registriertem UpDate belohnt!
  125. Bugreports und Vorschläge von registrierten Usern werden bevorzugt
  126. behandelt.
  127.  
  128. Verteilung
  129. ----------
  130. Das Programm ist Shareware. Es darf nur per DFÜ frei verteilt werden.
  131. Andere Verteilermodi sind vorher zu erfragen. Die Sharewaregebühr
  132. beträgt DM 20,- als Schein/Scheck. Wer sich das Programm auf Diskette
  133. für DM 10,- zusenden hat lassen, braucht nur noch DM 10,- für die
  134. Registrierung zu bezahlen. Quittung gibt es nur auf Anfrage.
  135. Neue Versionen werden in die QFAX-Box gepackt. Registrierte Benutzer
  136. erhalten darüber eine Drucksachenmitteilung (für den Preis ist ein
  137. Diskettenversand nicht möglich, außer bei wesentlichen neuen
  138. Versionen). Der registrierte Benutzer kann sich dann die neueste
  139. Version gegen frankierten Rückumschlag und formatierter Leerdisk
  140. von mir 'abholen'. Die registrierte Version hat neben
  141. mehr als dreimal soviel möglichen FAX-Adressen den Vorzug, daß auf einem angeschaltetem
  142. Drucker keine Shareware-Meldung erscheint (Ein ausgeschalteter Drucker
  143. wird nicht benutzt, aber Vorsicht: Spooler zählen nicht dazu!), gleiches
  144. gilt für die Dateien.
  145.  
  146. Anmerkung
  147. ---------
  148. Das Programm wurde aus verschiedenen Mailboxen schon einige Hundert
  149. Male geladen. Registriert sind aber erst vier Benutzer, wovon zwei
  150. einen größeren Fehler entdeckt haben. Zumindest eine Postkarte
  151. mit 'Nettes Programm' oder 'So ein Murks' wäre nett. Absender braucht
  152. ja nicht draufzustehen. Bei fehlendem Response macht es auch nicht viel
  153. Spaß Programm für alle zu schreiben UND dann auch noch auf Fehler-
  154. wünsche einzugehen!
  155.  
  156. Gewährleistung
  157. --------------
  158. Der Autor haftet für keinerlei Schäden, die durch die Benutzung
  159. der Software auftreten. Gleichwohl ist er natürlich interessiert an
  160. solchen Meldungen, da er versucht hat, alle Möglichkeiten zu
  161. berücksichtigen. Wichtig: Am Druckerport wird bei jedem Lauf eine
  162. Sharewaremeldung ausgegeben, d.h. andere Geräte sollten dort nicht
  163. angeschlossen sein!
  164.  
  165. Erweiterungen
  166. -------------
  167. Konvertierungsprogramm oder Benutzung anderer Telefonnummerndateien,
  168. wie von Connect u.a. (bitte Formatbeschreibung dazu einsenden).
  169. Einbau einer kleinen GEM-Shell u.a. zur Anwahl verschiedener
  170. Log-Dateien. Weitere Exportfunktionen für statistische Auswertungen
  171. (bitte Formatbeschreibungen einsenden).
  172.  
  173. Adresse
  174. -------
  175.   Jost Jahn
  176.   Neustädter Straße 11
  177. W-3123 Bodenteich
  178. Tel.: 05824-3197
  179. e-mail: j.jahn@abbs.hanse.de
  180. Z-Netz: J.JAHN@TTB.ZER
  181.  
  182. History
  183. -------
  184. 0.1   - 01.08.1992 - Erster Entwurf.
  185. 0.3   - 04.08.1992 - Grobe Fehler beseitigt.
  186. 0.5   - 08.08.1992 - Programm leicht verbessert und in QFAX-Box abgelegt.
  187. 0.51  - 10.08.1992 - Auslandsvorwahlen richtig, USA bei falscher Vorwahl.
  188. 0.52  - 11.08.1992 - Nummern mit '-'.
  189. 0.55  - 12.08.1992 - Berücksichtigung der Telefonzonen und Tag/Nachttarif.
  190. 0.6   - 14.08.1992 - In QFAX-Box abgelegt und als Z-NETZ Mitteilung.
  191. 0.61  - 21.08.1992 - In der Nightbox abgelegt.
  192. 0.62  - 27.09.1992 - Beschränkung auf 333 Teilnehmer (registrierte
  193.                      Version 999 Teilnehmer), GEMINI fähig,
  194.                      Auswertung von C:\QFAX.INF, LOG werden gelöscht,
  195.                      in der D-Box abgelegt, auch in der QFAX Box.
  196.                      Sharewaremeldung auf dem Drucker, Fehler im Klartext,
  197.                      Fehler bei der Uhrzeitangabe in QFAX_LOG.EIN
  198.                      beseitigt (Dank an Jörg H.), Fehlerstatistik.
  199. 0.7   - 24.10.1992 - Hinzufügen der Seitenzahl. Fehler bei Ortszone
  200.                      (Dank an Jörg H.) beseitigt. In QFAX Box abgelegt.
  201. 0.75  - 05.11.1992 - Hinzufügen der gelungenen Versuche. Unterschiedliche
  202.                      Weite der Standardweite von 80 Zeichen neu. Fehler
  203.                      bei nicht aufgetretenen Fehlern beseitigt (Dank
  204.                      an A.S.). Seltenen Fehler mit Auslandvorwahl vor
  205.                      dem Teilnehmer beseitigt. Nun auch für User aus dem
  206.                      Ausland in der QFAX_LOG.ZON Datei geändert. In
  207.                      QFAX Box abgelegt.
  208. 0.8   - 06.12.1992 - Umstellung der Erkennung der Nummer auf 'call',
  209.                      wg. Problemen mit Auslandsfaxgeräten (Danke, Micha).
  210.                      Berücksichtigung von 0130-Nummern (Dank an R.S.).
  211.                      Erläuterungen der Spalten direkt in QFAX_LOG.ALL.
  212.                      Hinzufügen von nicht zu berücksichtigenden Fehlern
  213.                      (z.B. userbrk) in den Ausgabedateien. Teilnehmer-
  214.                      anzahl nur durch den Speicher begrenzt. Summierung
  215.                      der Fehler korrigiert. WAITCARRIER aus QFAX.INF
  216.                      (bzw. INCLUDE Dateien) bei kostenpflichtigen
  217.                      Fehlern berücksichtigt. Seitenanzahl jetzt richtig.
  218.                      Ausgabe bei kleiner QFAX.LOG geändert. Fehleranalyse
  219.                      besser gelöst.
  220. 0.81  - 13.12.1992 - Ausgabe der Werte in QFAX_LOG.ALL auch für andere
  221.                      Statistikprogramme (als QFAX_ALL.ASC mit einem Blank
  222.                      als Trennzeichen, als QFAX_ALL.DIF mit einem Komma,
  223.                      letzteres identisch mit QFAX_ALL.CSV), für die
  224.                      Fehlerhäufigkeit als QFAX_ERR.TOR (TORTE von mir)
  225.                      Kleinerer Bug bei Spaltenberechnung der
  226.                      Fehleranzeige beseitigt. In QFAX-Box abgelegt. 
  227.